package com.vegetable.modules.service.finance;

import com.baomidou.mybatisplus.extension.service.IService;
import com.vegetable.modules.entity.finance.TransactionPaymentMatch;
import com.vegetable.modules.entity.finance.vo.TransactionPaymentMatchVO;

import java.math.BigDecimal;
import java.util.List;

/**
 * <p>
 * 交易流水与付款记录匹配关系 服务类
 * </p>
 *
 * @author Qoder
 * @since 2025-11-02
 */
public interface ITransactionPaymentMatchService extends IService<TransactionPaymentMatch> {

    /**
     * 根据付款记录ID查询关联的所有交易流水
     * @param paymentId 付款记录ID
     * @return 匹配关系列表
     */
    List<TransactionPaymentMatchVO> listByPaymentId(Long paymentId);

    /**
     * 根据交易流水ID查询关联的付款记录
     * @param transactionId 交易流水ID
     * @return 匹配关系列表
     */
    List<TransactionPaymentMatch> listByTransactionId(Long transactionId);

    /**
     * 根据付款记录ID查询关联的所有交易流水（包含详细信息）
     * @param paymentId 付款记录ID
     * @return 匹配关系VO列表
     */
    List<TransactionPaymentMatchVO> listVOByPaymentId(Long paymentId);

    /**
     * 根据交易流水ID查询关联的付款记录（包含详细信息）
     * @param transactionId 交易流水ID
     * @return 匹配关系VO列表
     */
    List<TransactionPaymentMatchVO> listVOByTransactionId(Long transactionId);

    /**
     * 根据付款记录ID查询已匹配的总金额
     * @param paymentId 付款记录ID
     * @return 已匹配的总金额
     */
    BigDecimal getMatchedAmountByPaymentId(Long paymentId);
    
    /**
     * 根据交易流水ID查询已匹配的总金额
     * @param transactionId 交易流水ID
     * @return 已匹配的总金额
     */
    BigDecimal getMatchedAmountByTransactionId(Long transactionId);

    /**
     * 删除指定付款记录与交易流水的关联关系
     * @param paymentId 付款记录ID
     * @param transactionId 交易流水ID
     * @return 是否删除成功
     */
    boolean removeByPaymentIdAndTransactionId(Long paymentId, Long transactionId);

    /**
     * 重新分配交易流水到目标付款记录（支持新增分配和调整分配）
     * @param transactionId 交易流水ID
     * @param targetPaymentId 目标付款记录ID
     * @param allocateAmount 分配金额（可选，为null时表示自动计算）
     * @return 是否重新分配成功
     */
    boolean reallocateTransactionToPayment(Long transactionId, Long targetPaymentId, BigDecimal allocateAmount);

    /**
     * 当交易流水的 ab_id 对应到某个代办时，自动将该流水与对应的代办付款记录进行匹配
     * @param transaction 交易流水
     * @return 是否匹配成功
     */
    boolean autoMatchTransactionToPayment(com.vegetable.modules.entity.finance.Transactions transaction);

    /**
     * 检查并更新付款记录状态
     * 当某条付款记录的所有关联交易流水金额累加等于该付款记录的 money 字段时
     * 自动将该付款记录的 state 字段更新为 1（实际已付）
     * @param paymentId 付款记录ID
     * @return 是否更新成功
     */
    boolean checkAndUpdatePaymentState(Long paymentId);
    
    /**
     * 根据付款记录ID查询关联的所有交易流水利息（包含交易流水信息）
     * @param paymentId 付款记录ID
     * @return 匹配关系列表（包含交易流水信息）
     */
    List<TransactionPaymentMatch> listByPaymentIdWithTransactionInfo(Long paymentId);

    /**
     * 根据交易流水ID查询关联的付款记录（包含付款记录信息）
     * @param transactionId 交易流水ID
     * @return 匹配关系列表（包含付款记录信息）
     */
    List<TransactionPaymentMatch> listByTransactionIdWithPaymentInfo(Long transactionId);
}